home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Auge 4000 / Auge 4000 #64 (1992-08-13)(Amiga User Gruppe Einzugsgebiet 4000).zip / Auge 4000 #64 (1992-08-13)(Amiga User Gruppe Einzugsgebiet 4000).adf / TKEd / doc / TKEd.doc.english < prev    next >
Text File  |  1992-06-28  |  61KB  |  1,856 lines
  1.   +-----------------------+
  2.  /                       /|
  3. +-----------------------+ |
  4. | Prg.name : TKEd V1.06 | | 
  5. | Date     : 18.06.1992 | +---------------------------+
  6. |                       |/                           /|
  7. +-----------------------+---------------------------+ |
  8. |     ----  Copyright Tom Kroener                   | |
  9. |    /(c)|            Richard Wagner Str. 40        | |
  10. |   / TKs|            D-6602 Saarbruecken-Dudweiler | |
  11. |  / 1991|            GERMANY                       | |
  12. | --------             +---------+                  | |-----------------+
  13. |                      | e-mail :|                  | |                /|
  14. |          +-----------+         +-----------+      | |               / |
  15. |          | kroener@cs.uni-sb.de (internet) |      | |              /  +
  16. |          | T_KROENER@SAARAG.ZER (Zerberus) |      | +             /  /|
  17. |          +----------------------------------+     |/             /  / |
  18. +---------------------------------------------------+-------------+  /  |
  19. | TKEd is NOT public-domain.                                      | /   |
  20. | It may not be used in commercial products without my permission |/    |
  21. +-----------------------------------------------------------------+     |
  22. | TKEd is SHAREWARE. You may copy TKEd and give it to other people|     |
  23. | as long as all files of the directory 'TKEd' are included and   |     |
  24. | no changes were made.                                           |     |
  25. | This version of TKEd allows you to load texts up to a length of |     |
  26. | 9999 Bytes.                                                     |     |
  27. | This should be enough to test TKEd.                             |     |
  28. | You can test TKEd for two or three weeks, but if you want to    |     |
  29. | use TKEd after this time, you have to send me the shareware     |     |
  30. | constribution ($25 (U.S.) or 30 DM)                             |     +
  31. | If you do so , you will become a registered user and you will   |    /|
  32. | get the latest update of TKEd (size of texts only limited       |   / |
  33. | by memory).                                                     |  /  +
  34. | ( If you send me an check, please use DM (Deutsche Mark)!!      | /  /
  35. |                                                                 |/  /
  36. +-----------------------------------------------------------------+  /
  37. | Registered user can get the newest version of TKEd for          | /
  38. | $3 (U.S.) or 5 DM.                                              |/
  39. +-----------------------------------------------------------------+
  40.  
  41.  
  42. See the file 'Changes' for the changes to earlier versions of TKEd !
  43.  
  44.  
  45. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  46.  
  47. In this documenttext, all of the menus are described in the order of
  48. their appearence.
  49. So it's easy to find the description of the new menus.
  50.  
  51.  
  52. First I want to thank Nico Francois for his great 'reqtools.library'.
  53. ( 'reqtools.library' is © Nico Francois)
  54.  
  55. Many thanks also to Michael Thiel and Stefan Winterstein for testing TKEd 
  56. and discussing errors and features of TKEd. 
  57.  
  58. **************************************************************************
  59. * Installation:                                                          *
  60. **************************************************************************
  61.  
  62. Start the program 'TKEd_Install' to install TKEd.
  63. (The disk from where you install TKEd shouldn't be write-protected).
  64.  
  65. If the files 'libs:reqtools.library' and 'libs:powerpacker.library' don't
  66. exist, TKEd_Install will copy them to your systems 'libs:'-directory.
  67. After that, TKEd_Install opens a filerequester to choose the directory 
  68. where you want to install TKEd.
  69. Clicking 'OK!' will start copying all the files to the selected
  70. directory.
  71. Clicking 'Forget it' will quit the program.
  72.  
  73. After that, start the program 'TKEd_Assign' from the directory where
  74. you have installed TKEd.
  75. This program assigns the logical directory 'TKEd:' to the current 
  76. directory of TKEd.
  77. You can also add the line 'assign TKEd: dh0:Utilities/TKEd'
  78. to the file 's:startup-sequence' to make this assign everytime you 
  79. boot your Amiga.
  80.  
  81. Instead of dh0:Utilities/TKEd, you have to write your path to the 
  82. directory 'TKEd'
  83.  
  84. After that, you can copy TKEd wherever you want.
  85.  
  86.  
  87. If you prefer to install TKEd 'by hand', you must create a directory 'TKEd'
  88.  
  89. and copy all the files and directories into it.
  90.  
  91. After that, you must copy the 'reqtools.library' and the 
  92.  
  93. 'powerpacker.library' to the 'libs:' directory.
  94.  
  95. The rest (the assigns) : see above !
  96.  
  97.  -----------------------------------------------------------------------
  98. | Important Important Important Important Important Important Important |
  99. |-----------------------------------------------------------------------
  100. |                                                                       |
  101. | 1.   TKEd needs a stack of 10000 to work correctly. Using less stack, |
  102. |      TKEd will break sometimes after some minutes.                    |
  103. |      If you run TKEd from the CLI or Shell, enter the command         |
  104. |      'stack 10000' before starting TKEd.                              |
  105. |      If you use your own icon for TKEd (= not the one I have created) |
  106. |      you have to set this stack yourself: Select the icon with the    |
  107. |      mouse, select the workbench-menu 'Info' and write the value of   |
  108. |      10000 into the field 'Stack'.                                    |
  109. |      Push the 'Return'-key and save this setting.                     |
  110. |                                                                       |
  111. | 2.   Don't use configuration files ('TKEd.cfg') of other versions of  |
  112. |      TKEd, because I have changed some information in it.             |
  113. |      The configuration files of this version (V1.01) will be          |
  114. |      compatible to future versions. (or if not I will include         |
  115. |      a tool to convert this file)                                     |
  116. |                                                                       |
  117. | 3.   If the menus or requesters are empty, you must install TKEd with |
  118. |      the program 'Install_TKEd' or you must copy 'by hand' the        |
  119. |      directory 'TKEd/Data' to the directory 'TKEd:'.  The files in    |
  120. |      this directory have the data for the menus.                      |
  121. |                                                                       |
  122.  -----------------------------------------------------------------------
  123. | Important Important Important Important Important Important Important |
  124.  -----------------------------------------------------------------------
  125.  
  126.  
  127.  
  128.  
  129. **************************************************************************
  130. * The Keys and the Mouse                                                 *
  131. **************************************************************************
  132.  
  133. -Keys-
  134.  
  135. Some of the menus of TKEd have shortcuts. This means, that you can
  136. also select a menu using the corresponding shortcut.
  137.  
  138. The standard (AmigaDos) way to call shortcuts is to hold down
  139. the right Amiga button and then press the specified button.
  140. (e.g Amiga+l will show the TKEd filerequester)
  141.  
  142. Some other shortcuts (e.g in the menu 'Misc') use the 'Ctrl' button
  143. instead of the right Amiga button.
  144. (e.g. Ctrl+l deletes one line ).
  145.  
  146. To move cursor up or down, use the cursor up/down keys in combination with
  147. the alt-, shift- or the ctrl- key.
  148.  
  149. Cursor up/down          : Moves cursor one line up/down
  150. Alt + cursor up/down    : Moves cursor 4 lines up/down
  151. Shift + cursor up/down  : Moves cursor one page up/down
  152. Ctrl + cursor up/down   : Moves cursor to the beginning/end of a text
  153.  
  154. Cursor left/right         : Moves cursor one character to the left/right
  155. Alt + cursor left/right   : Moves cursor one word to the left/right
  156. Shift + cursor left/right : Moves cursor to the left/right end of the window
  157. Ctrl + cursor left/right  : Moves cursor to the left/right end of a line
  158.  
  159. For moving through the text, you can also use some of the keys of the numeric
  160. keypad in combination with the Shift (or Alt) key.
  161.  
  162. Alt+Home  (Key 7) goes to the beginning of the text.
  163. Alt+End   (Key 1) goes to the end of the text.
  164. Alt+Pg Up (Key 9) goes one page up.
  165. Alt+Pg Dn (Key 3) goes one page down.
  166.  
  167.  
  168. The Help key shows some information about TKEd.
  169.  
  170. The requesters appearing in TKEd can also be handled by somne shortcuts:
  171. 'Y', 'Left amiga +V' or 'Return'-key      : OK
  172. 'N'  'Left amiga +B' 'R' or 'Esc'-key     : Cancel
  173.  
  174. The information-requesters (those with one gadget to click on) can easily be 
  175. closed using e.g. the 'Esc'-key
  176.  
  177. Attention:
  178. There is one exception to this rule: The requester appearing during
  179. 'Search/Replace' with the gadgets 'No' 'Cancel' 'Yes' accepts all shortcuts
  180. as a positive (='Yes') reponse.
  181. 'No' or 'Cancel' can only be used via mouse!
  182.  
  183.  
  184.  
  185. -Mouse-
  186.  
  187. You can place the cursor  pressing the left mousebutton at the character
  188. you want.
  189. If the cursor position would be right of the end of the line, it will be
  190. placed at the end of the line.
  191.  
  192. If you want to scroll the text up or down, move the mouse to the first or 
  193. to the last two lines of the visible part of the text, hold down the 
  194. left mousebutton and press any key or click the right mousebutton.
  195.  
  196. The mouse is also used to mark vertical block (see also 'Mark vertical
  197. Block').
  198.  
  199. **************************************************************************
  200. * Loading a text                                                         *
  201. **************************************************************************
  202.  
  203. There are 4 ways to load a text:
  204.  
  205. 1.  Start TKEd and use the menu 'Load'
  206.  
  207. 2.  Start TKEd from the CLI (or Shell) with the (path-) names of the texts:
  208.     (e.g. 'TKEd s:startup-sequence s:hd-startup' will start TKEd and load 
  209.      the texts 's:startup-sequence' and 's:hd-startup')
  210.      
  211. 3.  Hold down the 'Shift' key, select the icons of the texts, select the 
  212.     icon of TKEd and use the (workbench-) menu 'Open'.
  213.     TKEd will start and load all selected texts.
  214.     
  215. 4.  Select the icon of the text, start the (workbench-) menu 'Info',
  216.     and write the path of TKEd (e.g 'sys:Utilities') into the field
  217.     'Default Tool' .
  218.     After saving this, you can start TKEd by clicking the icon of
  219.     the text and TKEd will load the text.
  220.  
  221. 5.  If you use OS2.04 (or newer), the small window of an 'iconified'
  222.     TKEd (see menu 'Iconify') is an appWindow.
  223.     So you can load a text by dragging the icon of a text on this small 
  224.     window.
  225.  
  226. **************************************************************************
  227. * The Menus                                                              *
  228. **************************************************************************
  229.  
  230. All menus and texts in the requesters are english (default). If you want
  231. german menus and requesters, goto the prefs menu and choose the menu
  232. Language->German.
  233.  
  234. ATTENTION: The english and german texts of the menus and the requesters
  235.            are in the directory 'TKEd:Data'.
  236.            You shouldn't change this texts, because TKEd doesn't check
  237.            the correct length of each text, and a line longer than expected
  238.            can make some trouble while working with TKEd.
  239.            If you want a TKEd using french, spanish or another language:
  240.            Send me a letter (or better a disk) with the correct translations
  241.            of the texts in 'TKEd:Data' for your language.
  242.            With this data, I will add a menu for your language to the
  243.            'Prefs'-menu!
  244.  
  245.            
  246. +++++++++++
  247. + Project ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  248. +++++++++++  
  249. --------------------------------------------------------------------------  
  250.  
  251. -New-
  252.   Delete all the text.
  253.  
  254. -------------------------------------------------------------------------- 
  255.  
  256. -Open-
  257.   Opens a filerequester to choose the file to load.
  258.   If the text was packed with the PowerPacker, TKEd needs more memory to 
  259.   decrunch it. If you have not enough memory to do this, first decrunch
  260.   the text with the PowerPacker (See Fish 253 for the PD-version of
  261.   the PowerPacker) and then load the decrunched text.
  262.  
  263. --------------------------------------------------------------------------
  264.  
  265. -Save-
  266.   Saves the text.
  267.   If TKEd finds not enough memory to save the text in the 'normal' mode,
  268.   it saves the text in a slower mode that doesn't need any additional 
  269.   memory.
  270.  
  271. --------------------------------------------------------------------------
  272.   
  273. -Save As-
  274.   Opens a filerequester to choose the path and the filename for saving
  275.   the text.
  276.  
  277. --------------------------------------------------------------------------
  278.  
  279. -Print-
  280.   Sends the text to the printer.
  281.  
  282. --------------------------------------------------------------------------
  283.  
  284. -Insert File-
  285.   Opens a filerequester to choose the file to be inserted in the
  286.   text.
  287.   The file will be inserted between the current line and the previous 
  288.   line .
  289.  
  290. --------------------------------------------------------------------------
  291.  
  292. -About-  
  293.   Shows some information about the author and the version of TKEd.
  294.   The name of the current AREXX-port (for the first TKEd 'TKEd.1',
  295.   for the second 'TKEd.2'....) is also showed.
  296.   This is the name you have to use in an AREXX-program to address the 
  297.   AREXX-port of TKEd. (e.g. "address 'TKEd.1'")
  298.  
  299. --------------------------------------------------------------------------
  300.  
  301. -Iconify-
  302.   This 'iconifies' TKEd, what means that TKEd closes its screen and its
  303.   window and opens a very small window on the workbench screen.
  304.   So it needs 50.000 Byte less chipmemory.
  305.   You can also force this option with the parameter '-i' from CLI or Shell.
  306.   Use the parameter '-i' as the last parameter. (after the filenames
  307.   to load).
  308.  
  309.   Click with the left mousebutton on the closing gagdet or with the
  310.   right mousebutton anywhere on the small window to get the
  311.   'normal' size of TKEd.
  312.  
  313.   If you use OS2.04 (or newer), the small window is an appWindow:
  314.     -When you put with the mouse the icon of a text on it, TKEd 
  315.      returns to its 'normal' state and tries to load this text
  316.  
  317. --------------------------------------------------------------------------
  318.  
  319. -Sleep-
  320.   This removes the screen and the window of TKEd, but keeps TKEd itself
  321.   ( and all the texts) in memory.
  322.  
  323.   You can invoke TKEd by pessing the keys 'Ctrl' 'Shift' 'Alt' 'Space'
  324.   simultaniously.
  325.   TKEd also awakes when it receives any AREXX-command.
  326.  
  327.   You can force this option with the parameter '-s' from CLI or Shell.
  328.  
  329. --------------------------------------------------------------------------
  330.       
  331. -SaveAll & Quit-
  332.   Saves all modified buffers and quit TKEd.
  333.  
  334. --------------------------------------------------------------------------
  335.       
  336. -Save & Quit-
  337.   Saves the text and quit TKEd.
  338.  
  339. --------------------------------------------------------------------------
  340.   
  341. -Quit-
  342.   Quit TKEd.
  343.  
  344. --------------------------------------------------------------------------
  345. +++++++++
  346. + Prefs ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  347. +++++++++
  348. --------------------------------------------------------------------------
  349.   
  350. -Load-
  351.   If you have changed the preferences, you can load the preferences which
  352.   you have saved earlier.
  353.   If you start TKEd, it does this automaticly.
  354.   It looks in the current directory for a file named 'TKEd.cfg', and
  355.   if nothing is found, it looks for it in the directory 'TKEd:'.
  356.   If it has found nothing, TKEd will start with a default
  357.   configuration.
  358.   
  359.  
  360. --------------------------------------------------------------------------
  361.   
  362. -Save-
  363.   Opens a filerequester to save your preferences.
  364.   Default filename is 'TKEd:TKEd.cfg'
  365.   The information saved is:
  366.     -The colors
  367.     -The number of spaces for each tab
  368.     -If auto indent is on or off
  369.     -The information of the 'Backup'- submenus
  370.     -All the data of the User - menus (commands, texts, etc)
  371.     -All the data of the ARexx - menus
  372.     -The shortcuts of the 'Amiga'- menus.
  373.     -The information of the 'Language', 'Screen' and 'Fonts' menus
  374.  
  375.   ATTENTION:
  376.     Never edit a configurationfile of TKEd or the files in the directory 
  377.     'TKEd:Data' 'by hand' using an ASCII- or HEX-editor.
  378.     TKEd espects the format it had saved earlier and doesn't check
  379.     all values in the file.
  380.  
  381.  
  382. --------------------------------------------------------------------------
  383.  
  384. -Default-
  385.     Sets the preferences to the default values and clears all User - menus
  386.     and all ARexx - menus.
  387.  
  388. --------------------------------------------------------------------------
  389.  
  390. -Language-
  391.   - English
  392.     English menus and englsih requesters
  393.  
  394.   - Deutsch
  395.     German menus and german requesters
  396.  
  397. --------------------------------------------------------------------------
  398.  
  399. -Screen
  400.   - Set horiz. Position-
  401.     Sets the horizontal position of the screen (only OS >= 2.0)
  402.  
  403.   - Set vert. Position-
  404.     Sets the vertical position of the screen
  405.  
  406.   - Set horiz. Size-
  407.     Sets the width of the screen. TKEd computes a with corresponding
  408.     to the width of the current font
  409.  
  410.   - Set vert. Size-
  411.     Sets the hight of the screen. TKEd computes a hight corresponding
  412.     to the hight of the current font
  413.  
  414.   - Interlace-
  415.     Switches interlace on/off
  416.  
  417. --------------------------------------------------------------------------
  418.  
  419. -Fonts-
  420.   Here you can choose the size of the font
  421.  
  422.   IMPORTANT:  If you want to use the fonts, first start the program
  423.               'Install_Font' to copy the TKEd-fonts to your 'fonts:'
  424.               directory.
  425.   
  426. --------------------------------------------------------------------------
  427.  
  428. -Colors-
  429.   Opens a color requester to change the colors of TKEd.
  430.  
  431.  
  432. --------------------------------------------------------------------------
  433.    
  434. -Tab Size-
  435.     How many spaces are printed for one tab ( TKEd handles no tabs).
  436.  
  437. --------------------------------------------------------------------------
  438.  
  439. -Folds Start
  440.   Opens a requester to enter the text which TKEd uses to recognize
  441.   the start of a folding (max. 20 characters)
  442.  
  443. --------------------------------------------------------------------------
  444.  
  445. -Folds End
  446.   Opens a requester to enter the text which TKEd uses to recognize
  447.   the end of a folding (max. 20 characters)
  448.  
  449. --------------------------------------------------------------------------
  450.  
  451. -ShortCuts-
  452.     Gives you the possibility to define your own shortcuts for the
  453.     menus using the standard AmigaDos shortcuts (not the menus with
  454.     the Ctrl-key-shortcuts).
  455.     Shows a textrequester with a string containing the characters
  456.     of the shortcuts of the menus (in the order of their appearance).
  457.     To change a shortcut, delete the character you want to change
  458.     and replace it by the one you like.
  459.  
  460. --------------------------------------------------------------------------
  461.     
  462. -Auto Indent-
  463.     If auto indent is off, each line (after pressing 'RETURN') starts
  464.     at column 1.
  465.     If auto indent is on, each line starts under the first character
  466.     of the previous line, which is not a space.
  467.  
  468.         
  469. --------------------------------------------------------------------------
  470.  
  471. -Backup-
  472.   Some functions to specify the way TKEd makes backups:
  473.   
  474.  
  475.   -Safe Saves-
  476.     IF 'Safe Saves' is on, TKEd will first rename an existing file bevore
  477.     overwriting it.
  478.     After succesful saving, TKEd will remove the renamed file.
  479.  
  480.   -AutoBackup-
  481.     If 'AutoBackup' is on, TKEd makes a backup of your text (with the ending
  482.     '.bak') while saving a text
  483.  
  484.   -VersionBackup-
  485.     If 'VersionBackup' is on, TKEd makes different versions of backups
  486.     of your text (with the ending '.bakX') while saving a text.
  487.     X stands for a digit from 0 to 30000.
  488.     Example:If you have a text named 'Letter' and you save it three times,
  489.             the backups 'Letter.bak0', 'Letter.bak1' and 'Letter.bak2'
  490.             will be created.
  491.             The newest version of the text will still have the name 'Letter'.
  492.             The eldest version will have the name 'Letter.bak0'
  493.             
  494.   -TimeBackup-
  495.     If 'TimeBackup' is on, TKEd remembers you every 15 minutes (if text
  496.     is modified) to save the text.
  497.     
  498.   -Set Extension-
  499.     Opens a requester to enter the extension for the backups.
  500.     (Default: '.bak')
  501.  
  502. --------------------------------------------------------------------------
  503.  
  504. -Show Files-
  505.   Opens a requester to enter the name of files you want to see
  506.   in the filerquester.
  507.   Accepts wildcards like '#' and '#?'. You can also use '~' as logical
  508.   not.
  509.   Default: ~(#?.bak#?) ==> show all files without '.bak' in the name.
  510.  
  511. --------------------------------------------------------------------------
  512.  
  513. -Search Prefs-
  514.   To submenus for the search/replace function
  515.  
  516.   -Ignore Case-
  517.     Ignore the case of a character (e = E)
  518.  
  519.   -Wildcards-
  520.     You can use '?' in the searchstring as a wildcard.
  521.     Example: If you search the string 'c?me' you will find all words like
  522.              'come', 'came' 'cyme' ...
  523.     Wildcards only works if 'Ignore Case' is switched on.
  524.  
  525. --------------------------------------------------------------------------
  526. ++++++++++
  527. + Search +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  528. ++++++++++
  529. --------------------------------------------------------------------------
  530.  
  531. -Find-
  532.   Shows a textrequester to enter the text to search for.
  533.  
  534. --------------------------------------------------------------------------
  535.   
  536. -Next-
  537.   Goes to the next occurrence of the text to search for.
  538.  
  539. --------------------------------------------------------------------------
  540.  
  541. -Previous--
  542.   Goes to the previous  occurrence of the text to search for.
  543.  
  544. --------------------------------------------------------------------------
  545.  
  546. -Search/Replace-
  547.   Shows a textrequester to enter the text to search for,
  548.   than another textrequester to enter the text which shall
  549.   replace the searched text.
  550.   After that, for each occurrence of the search text, a requester
  551.   will ask you whether you want to replace the text, whether you
  552.   don't want to replace  it or whether you want to stop the 
  553.   searching/replacing.
  554.  
  555. --------------------------------------------------------------------------
  556.  
  557. -Replace next-
  558.   Goes to the next occurrence of the searched text and asks to replace it.
  559.  
  560. --------------------------------------------------------------------------
  561.   
  562. -Replace previous-
  563.   Goes to the previous occurrence of the searched text and asks to 
  564.   replace it.
  565.  
  566. --------------------------------------------------------------------------
  567.  
  568. -Replace all-
  569.   Like search/replace, but it replaces all occurrences in the text 
  570.   without asking.
  571.  
  572. --------------------------------------------------------------------------
  573.  
  574. -Count Occurences-
  575.   Like the menu 'Find', but counts all the occurences in the text.
  576.   
  577. --------------------------------------------------------------------------
  578.  
  579. -Matching Bracket-
  580.   If the cursor is positioned over a bracket, this function will locate
  581.   the bracket belonging to this bracket (if there is any).
  582.   Handles (), [] and {}.
  583.   
  584. --------------------------------------------------------------------------
  585.  
  586. -Goto Mark 0-
  587.    ...
  588.    ...
  589. -Goto Mark 9-
  590.     If you have marked a line (see New Mark) TKEd will move to the
  591.     marked line.
  592.     Very nice if you use the shortcuts 0,1,...8,9.
  593.  
  594. --------------------------------------------------------------------------
  595.  
  596. -New Mark-
  597.     Marks the current line with the number you enter in the requester.
  598.     You can set up to 10 different marks by using the numbers 0..9.
  599.     Using a number twice will overwrite the first mark.
  600.  
  601. --------------------------------------------------------------------------
  602.             
  603. -Clear Mark-
  604.     Clears the mark you select.    
  605.     
  606. --------------------------------------------------------------------------
  607. +++++++++
  608. + Block ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  609. +++++++++
  610.  
  611. Remark: If you want copy very large blocks, it's better to use 'Save Block' 
  612.         and 'Insert Block' instead of 'Copy' and 'Paste', because
  613.         'Copy' and 'Paste' needs much more time (and memory) than
  614.         'Save Block' and 'Insert Block'.
  615.  
  616. --------------------------------------------------------------------------
  617.  
  618. -Mark Block-
  619.   Marks the beginning of a block.
  620.   Move the cursor up/down to mark the end of the region.
  621.   (Only movements without 'Alt'- or 'Shift'-key)
  622.   If you don't want to mark all the lines while moving up/down
  623.   press the right 'Alt' key ; these lines will not be marked
  624.   You can also move the cursor to the right to change the left beginning
  625.   of a marked line.
  626.  
  627. --------------------------------------------------------------------------
  628.   
  629. -Mark vertical Block-
  630.   Use this to mark vertical blocks.
  631.   To specify the width of the vertical block, move the mouse from left
  632.   to right will holding down the left mousebutton
  633.   Move the cursor up/down to mark the end of the region.
  634.  
  635.   You also can mark every line you want (e.g. line 2, 3, 16, 29...) and 
  636.   in  each line a different part  of it (e.g. line 2  : character 1 to 7,
  637.                                               line 5  : character 17 to 97
  638.                                               line 100: charcater 102 to 104...)
  639.   
  640.   if you place the mouse at a different line and mark the line 
  641.   with it (see above).
  642.   This will not remove the marks you have done earlier.
  643.  
  644.   After 'Copy' or 'Cut', the lines are all in an internal block.
  645.  
  646. --------------------------------------------------------------------------
  647.  
  648. -Cut Block-
  649.   Cuts all the marked charcters from the text into an internal buffer.
  650.  
  651. --------------------------------------------------------------------------
  652.   
  653. -Copy Block-
  654.   Copies all the marked characters into an internal buffer.
  655.  
  656. --------------------------------------------------------------------------
  657.   
  658. -Delete Block-
  659.   Deletes all lines of a marked block.
  660.   Could be also realized using 'Cut Block' but needs no extra memory.
  661.  
  662. --------------------------------------------------------------------------
  663.  
  664. -Paste Block-
  665.   Inserts a block from the internal buffer to the text.
  666.   Each line of the internal buffer will have a new  line in the text.
  667.  
  668. --------------------------------------------------------------------------
  669.  
  670. -Paste vertical Block-
  671.   Inserts a block from the internal buffer into the lines of the text.
  672.   ( no new lines will be created)
  673.   Each line of the internal buffer will be inserted in an existing line
  674.   from the current  position of the cursor.
  675.   If the line would be too long, a part of the line from the internal
  676.   buffer will be lost.
  677.   If 'Paste vertical Blocks' reaches the end of the text, it stops.
  678.   
  679. --------------------------------------------------------------------------
  680.  
  681. -Block->-
  682.   Moves each line of a marked block one column to the right.
  683.   
  684. --------------------------------------------------------------------------
  685.  
  686. -Block<--
  687.   Moves each line of a marked block one column to the left.
  688.   Lines beginning at column 1 will not be moved.
  689.   
  690. --------------------------------------------------------------------------
  691.   
  692. -Unmark Block-
  693.   Unmarks a marked block.
  694.  
  695. --------------------------------------------------------------------------
  696. ===============
  697. About foldings: With TKEd you ahve the possibility to fold parts of a
  698. =============== text.
  699.                 The folded parts of a text are still in memory, but not 
  700.                 visible on the screen.
  701.                 This function makes it much easier to work with large
  702.                 text or programs.
  703.                 For the start and the end of a folded block exist two
  704.                 keywords (see menu 'Prefs'), which can be any kind of
  705.                 text (up to 20 charcters).
  706.                 The default keywords are '(*On*)' and '(*Off*)', so my
  707.                 compile handle it like commends.
  708.                 All text between this two line (including this lines)
  709.                 will be invisible after selecting the menu 'Fold text'.
  710.                 If you have folded large blocks, TKEd will be a little
  711.                 bit slower than normaly, but I think its not to much.
  712.  
  713.     Important:  Functions like 'Search','Replace', 'Cut Blocks' work
  714.                 not correctly with folded blocks, so unfold the parts
  715.                 of a text before you use this functions.
  716.                 All this functions only see the text that you see!                
  717.                 
  718. --------------------------------------------------------------------------
  719.  
  720. -Fold marked text-
  721.   Inserts the keywords in the first and the last marked line and calls
  722.   the function 'Fold text'.
  723.  
  724. --------------------------------------------------------------------------
  725.  
  726. -Fold next-
  727.   Folds the next possible part of a text (if exist)
  728.  
  729. --------------------------------------------------------------------------
  730.  
  731. -Unfold next-
  732.   Unfolds the next folded part of a text (if exist)
  733.  
  734. --------------------------------------------------------------------------
  735.  
  736. -Fold text-
  737.   Folds all possible parts of a text.
  738.  
  739. --------------------------------------------------------------------------
  740.  
  741. -Unfold text-
  742.   Unfold all folded parts of a text.
  743.  
  744. --------------------------------------------------------------------------
  745.  
  746. -Insert Block-
  747.   Opens a filerequester to load a saved block.
  748.   Default name: 't:blk'
  749.   
  750. --------------------------------------------------------------------------
  751.   
  752. -Print Block-
  753.   Sends the internal buffer (see 'Copy' and 'Cut') to the printer.
  754.  
  755. --------------------------------------------------------------------------
  756.  
  757. -Save Block-
  758.   Shows a filerequester to choose the path and the filename for saving
  759.   the internal block. (See also 'Copy' and 'Cut' ).
  760.   Default name:  't:blk'
  761.   
  762. --------------------------------------------------------------------------
  763. +++++++++   +++++++++
  764. + User1 +++++ User2 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
  765. +++++++++   +++++++++
  766.   
  767. --------------------------------------------------------------------------
  768.  
  769. -F1 - F10-
  770.  
  771.   If you don't want to use the mouse, pressing the keys F1 - F10, 
  772.   will also execute the command.
  773.  
  774. --------------------------------------------------------------------------
  775.  
  776. -Select command-
  777.   Opens a filerequester to select the program to execute.
  778.   A path to a program can be saved with the preferences.
  779.  
  780. --------------------------------------------------------------------------
  781.  
  782. -Set Menu:-  (1-5)
  783.   Shows a textrequester which allows you to enter the command that will
  784.   be executed if you select the menu or the function key that belongs 
  785.   to the menu.
  786.   If the command contains [] , TKEd will show a requester ( while 
  787.   excuting the command) and you can enter a text, which will replace
  788.   the []. If the [] are in a text, be sure that one blank is before
  789.   and (if text follows) one blank is after the [].
  790.   Examples : copy [] to ram:
  791.              execute []
  792.              
  793.   If the command contains {}, TKEd will replace the {} by the name of the
  794.   currently loaded file. (be sure to save your text if you have modified
  795.   it).
  796.   About the blanks before or after the {} : see above.
  797.   Examples : copy {} to ram:
  798.              lc -l {}
  799.              
  800.   If the command contains (), TKEd will open a filerequester to make it
  801.   easy to enter the path to a file.
  802.   Example :  muchmore ()
  803.              
  804.   Combinations of {}, () and [] are possible; you can also use each kind
  805.   of bracket several times.
  806.   Examples : copy {} to []
  807.              rename () ()
  808.              lc [] {}
  809.              
  810.   The command text (after inserting the parameters for (),[] or {} )
  811.   can have a length up to 255 characters.
  812.              
  813.   After the textrequester for the command, another one will appear which
  814.   allows you to enter the text which will be shown in the menu.
  815.   This text can have a length up to 18 characters.
  816.   
  817.   If you save your preferences, this data will be saved and reloaded
  818.   everytime you start TKEd.
  819.   
  820.   If you set a menu, existing data will be overwritten, so you
  821.   don't have to clear it first.
  822.   
  823.   To give you the possibility to have a look at the output of an executed
  824.   command, TKEd normaly makes a 'Workbenchtofront' before executing a
  825.          g.SetDrMd (rp, SHORTSET{g.inversvid});
  826. X, 0);
  827. ve his ok to close
  828.   the outputwindow.
  829.   If you don't want to see anythink, add the keyword 'noreq' to the
  830.   command.
  831.   
  832.  
  833. --------------------------------------------------------------------------
  834.   
  835. -Clear Menu-
  836.   Clears the data of the menu.
  837.  
  838. --------------------------------------------------------------------------
  839. ++++++++++   ++++++++++
  840. + ARexx1 +++++ ARexx2 ++++++++++++++++++++++++++++++++++++++++++++++++++++
  841.  
  842. +++++++++   ++++++++++
  843. --------------------------------------------------------------------------
  844.   
  845. -Shift F1 - Shift F10-
  846.  
  847.   If you don't want to use the mouse, pressing the keys Shift F1 - Shift F10
  848.   will also execute the command.
  849.  
  850. --------------------------------------------------------------------------
  851.  
  852. -Select command-
  853.   Opens a filerequester to select the AREXX-program to execute.
  854.   A path to a program can be saved with the preferences.
  855.  
  856. --------------------------------------------------------------------------
  857.  
  858. -Set Menu:-  (1-5)
  859.   Shows a textrequester which allows you to enter the name of a
  860.   AREXX-program that will be executed if you select the menu or the 
  861.   function key that belongs to the menu.
  862.  
  863.   After the textrequester for the command, another one will appear which
  864.   allows you to enter the text which will be shown in the menu.
  865.   This text can have a length up to 18 characters.
  866.   
  867.   If you save your preferences, this data will be saved and reloaded
  868.   everytime you start TKEd.
  869.   
  870.   If you set a menu, existing data will be overwritten, so you
  871.   don't have to clear it first.
  872.  
  873.   TKEd searches the AREXX-program first in the current directory, then in
  874.   the directory 'REXX:'.
  875.  
  876.   TKEd executes an AREXX-program synchronous (you have to wait until
  877.   the program has terminated).
  878.   If you add the keyword 'async' to the command-text, the AREXX-program 
  879.   will be executed asynchronous, so you can work with
  880.   TKEd will the AREXX-program is running in the backround.
  881.   
  882.   After the AREXX-program has terminated, a requester will appear displaying
  883.   the results of the AREXX-program.
  884.   Both results should be 0 (if the program returns no errors)
  885.  
  886.   If you don't want this requester, add the keyword 'noreq' to the
  887.   name of the AREXX-program.
  888.   
  889.  
  890. --------------------------------------------------------------------------
  891.   
  892. -Clear Menu-
  893.   Clears the data of the menu.
  894.  
  895. --------------------------------------------------------------------------
  896. +++++++++
  897. + Misc1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++    
  898. +++++++++
  899.  
  900. -Page Up-
  901.   Moves the cursor one page up.
  902.  
  903. -Page down-
  904.   Moves the cursor one page down.
  905.  
  906. -Begin of file-
  907.   Moves the cursor to the very first character position in the file.
  908.  
  909. -End of file-  
  910.   Moves the cursor to the last page of the file.
  911.  
  912. -Begin of line-
  913.   Moves the cursor to column 1 of the current line.
  914.  
  915. -End of line-
  916.   Moves the cursor to the right end of the current line.
  917.  
  918. -Goto line-
  919.   Shows a requester which allows you to enter the number of the line 
  920.   to go to.
  921.  
  922. -Next Word-
  923.   Moves the cursor to the next word.
  924.   
  925. -Previous Word-
  926.   Moves the cursor to the previous word.
  927.  
  928. --------------------------------------------------------------------------
  929.  
  930. -Macros-
  931.   -Start Learning-
  932.     If you select this, TKEd will ask you the key to assign the macro to.
  933.     You can use all the keys of your keyboard (except shift and alt).
  934.     If you use the qualifiers 'shift' or 'alt', you can specify up to
  935.     3 different macros for each key (key, key+shift, key+alt).
  936.  
  937.     After this all actions you make (including keys, menus etc.)
  938.     will be  recorded by TKEd until you select 'Macros -Stop Learning-'.
  939.     If you want to include cursor movements which need qualifiers like
  940.     'shift', 'alt' or 'Ctrl', it is better to use the corresponding menus
  941.     to realise this movements.
  942.     ( e.g. use menu 'End of line' instead of 'shift + cursor right').
  943.  
  944.   -Stop Learning-
  945.     Stops the recording of your actions.
  946.  
  947.   -Load Macros-  
  948.     Loads macros you have saved earlier.
  949.     TKEd automaticly loads the macros everytime you start it.
  950.     
  951.   -Save Macros-
  952.     Saves all macros to the directory 'TKEd:Macros'.
  953.     
  954.   -Clear one Macro-
  955.     If you push a key which is assigned to a macro, this macro will 
  956.     be deleted.
  957.   
  958.   -Clear all Macros-
  959.     Clears all the macros.
  960.     If you don't want to load macros while starting TKEd, 
  961.     use 'Save macros' after you have cleared.
  962.     If you don't want to load macros while starting TKEd, 
  963.     use 'Save macros' after you have cleared.
  964.  
  965. ---------------------------------------------------------------------------
  966.  
  967. -Undo-
  968.   -Current line-
  969.     Restores the current line if modified.
  970.     ATTENTION: TKEd can remember only the lines after a 'Garbage Collection.
  971.                Lines modified before a 'Gabage Colleaction; will not be
  972.                restored.
  973.                The maximum lines TKEd can remember is 200: If more lines
  974.                are modified, TKEd will automaticly make a 
  975.                'Garbage Collection'.
  976.                A 'Garbage Collection' will also happen if you save a text
  977.                or if you change the buffer !.
  978.  
  979.   -All lines-
  980.     Restores all modified lines (see above).
  981.  
  982.   -Undelete line-
  983.    If you have deleted a line with the function 'Delete line', this will
  984.    re-insert the line in the text.
  985.  
  986.   -Undelete Block-
  987.    If you have deleted a block via the menu 'Block... Delete', you can 
  988.    restore this block with this function.
  989.  
  990. ---------------------------------------------------------------------------
  991.  
  992. -Mark modified-
  993.   Marks all modified lines (up to 200, see 'Undo').
  994.   Helpfull before making 'Undo'
  995.  
  996.  
  997. +++++++++
  998. + Misc2 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++    
  999. +++++++++
  1000.   
  1001. -Delete Word-
  1002.   Delete word removes the rest of the word the cursor is standing on.
  1003.  
  1004. --------------------------------------------------------------------------
  1005.   
  1006. -Delete line-
  1007.   Delete line removes the current line.
  1008.  
  1009. --------------------------------------------------------------------------
  1010.  
  1011. -Delete to EOL-
  1012.   Delete to EOL removes the contents of the current line from the
  1013.   cursor position towards the right end of the line. 
  1014.  
  1015. --------------------------------------------------------------------------
  1016.  
  1017. -JoinLines-
  1018.   Joins the current line with the previous line
  1019.   
  1020. --------------------------------------------------------------------------
  1021.  
  1022. -Clone line-
  1023.   Makes a copy of the current line
  1024.  
  1025. --------------------------------------------------------------------------
  1026.   
  1027. -Swap Chars-
  1028.   Swaps the character on which the cursor stands, and the following one.
  1029.  
  1030. --------------------------------------------------------------------------
  1031.  
  1032. -Swap Case-
  1033.    Changes the character under the cursor from uppercase (lowercase) to
  1034.    lowercase (uppercase).
  1035.    
  1036. --------------------------------------------------------------------------
  1037.  
  1038. -Errors-:
  1039.  
  1040.  It is useful for programmers if an editor has the possibility to display
  1041.  the error-messages of their compilers.
  1042.  Most of the compilers have their own style to show up errors, and I don't
  1043.  know all of them.
  1044.  So I decide to create a (simple) standard for the error-messages, and 
  1045.  TKEd is able to work with it.
  1046.  If your compiler differs from this standard, you have two possibilities:
  1047.  
  1048.  a) Write a small tool which converts the error-messages of your compiler 
  1049.     into a form which can be read by TKEd.
  1050.     Most of the compilers put their messages into an opened console window,
  1051.     so it's easy to redirect them into a file (my tool 'TKA68KErr' executes
  1052.     the command 'A68K > ram:tmperr' and modifies the created file 
  1053.     'ram:tmperr').
  1054.     
  1055.  b) If you don't know how to write such a tool, start your compiler, 
  1056.     redirect the output into a file ( like 'compile > ram:text.err')
  1057.     and send this file and some information about your compiler
  1058.     ( language, version ...) to me.
  1059.     If possible (and if I have enough time to do that), I will write
  1060.     the tool 
  1061.  
  1062. So and now the information about the format TKEd needs: 
  1063.  
  1064. 1.
  1065.   The tool must create a file named 'ram:TKErr' that contains the information
  1066.   for TKEd.
  1067.   
  1068. 2.
  1069.   For each error, the file must contain three lines of information:
  1070.   a)  The linenumber of the error
  1071.   b)  The column of the error
  1072.   c)  The error-message (maximum length: 144 characters)
  1073.  
  1074.   All the information must be normal ascii-text.
  1075.   ( You have to save the linenumber as a string, not as an integer !!)
  1076.   
  1077. 3.
  1078.   Be sure that there are no empty lines between the three lines
  1079.   belonging to one error.
  1080.     
  1081. 4.
  1082.   An example for a text showing three errors:
  1083.   
  1084.   2
  1085.   12
  1086.   Syntax error
  1087.   10
  1088.   1
  1089.   ) expected
  1090.   33
  1091.   5
  1092.   Unexpected end of file
  1093.   
  1094. 5.
  1095.   Be sure that your tool works correctly, because TKEd doesn't control
  1096.   what it reads.
  1097.   If your tool creates an uncorrect file, the error menus will show
  1098.   anything but not the errors.
  1099.   
  1100. 6.
  1101.   The tools should work like normal dos commands, so that it can
  1102.   be started using the 'User'-menus (see above).
  1103.  
  1104. 7.
  1105.   On this disk, I include 2 errortools:
  1106.  
  1107.   Name:            Compiler:          Language:        Author:
  1108.   ------------------------------------------------------------------------
  1109.   TKOberonErr      Oberon V2.0        Oberon           Tom Kroener
  1110.   TKA68KErr        A68K V2.61         Assembler        Tom Kroener
  1111.  
  1112.  
  1113.   The tools are in the directory 'ErrorTools' and should be used
  1114.   from the usermenus of TKEd.
  1115.   I don't know if these tools work fine with other versions of these 
  1116.   compilers, but I hope so.   
  1117.   
  1118.   If you use TKOberonErr, the program 'OErr' (a tool belonging to the 
  1119.   Oberon-compiler) should be placed in a directory of a path for 
  1120.   AmigaDos commands (e.g. 'sys:', 'c:' or other added paths).
  1121.  
  1122.   If you use TKA68KErr, the program 'A68K' .... (see above)
  1123.  
  1124.  
  1125.   If someone programs such a tool for any other compiler and it works
  1126.   fine, I would be happy if he (or she) send it to me.
  1127.   I will publish it with the next version of TKEd. 
  1128. --------------------------------------------------------------------------
  1129.   
  1130. -First Error-
  1131.   Jumps to the first error and displays a requester with the errormessage.
  1132.  
  1133. --------------------------------------------------------------------------
  1134.   
  1135. -Next Error-
  1136.   Jumps to the next error and displays a requester with the errormessage.
  1137.       
  1138. --------------------------------------------------------------------------
  1139.     
  1140. -Enter Ascii-
  1141.    Allows you to enter the ascii value of a character (0-255) 
  1142.  
  1143. --------------------------------------------------------------------------
  1144.  
  1145. -Free Memory-
  1146.    Gives you some information about the available memory.  
  1147.    
  1148. ++++++++++
  1149. + Buffer +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  1150. ++++++++++
  1151.  
  1152. -Goto Buffer-
  1153.   0..9  : Shows the text in buffer 0..9
  1154.  
  1155.  
  1156. *********
  1157. * AREXX *+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  1158. *********
  1159.  
  1160. Most of the functions of TKEd can be used by an AREXX program.
  1161. The AREXX-port of TKEd has the name 'TKEd.1' and can be accessed after
  1162. the ARREX-command 'address 'TKEd.1''.
  1163. Attention: The Portname is TKEd.1, not TKED.1 (it's a small 'd')
  1164. For further details consult your ARREX-manual.
  1165.  
  1166. For each TKEd you start, another port with another number as extension
  1167. will be opened (e.g if you start TKEd three times,  the ports
  1168. 'TKEd.1', 'TKEd.2' and 'TKEd.3' will exist).
  1169.  
  1170. The commands are not case  sensitive, therefore 'InsertFile',
  1171. 'INSERTFILE', 'inSErtfILe'... calls all the same function
  1172. of TKEd.
  1173. Some commands need special parameters like 'UP', 'DOWN', 'LEFT',
  1174. 'RIGHT', 'ON', 'OFF', 'FORCE'...
  1175. These parameters are case sensitive    !!!!!!!!
  1176. Use capital letters for this parameters !!!!!!
  1177.  
  1178. Normaly, TKEd executes an AREXX-program synchronous (you have to wait
  1179. until the program has terminated).
  1180. If you add the keyword 'async' to the command-text of the menu , the 
  1181. AREXX-program will be executed asynchronous, so you can work with
  1182. TKEd will the AREXX-program is running in the backround.
  1183. If the AREXX-program terminates, a textrequester will show you
  1184. the results.
  1185. If you add the keyword 'noreq' to the command-text of the menu , this
  1186. requester will not appear.
  1187.  
  1188.  
  1189. Now the list of the names, functions, parameters and results of the
  1190. AREXX-functions:
  1191.  
  1192.  
  1193. No.  Name
  1194.      -Function
  1195.      -Parameters
  1196.      -Returnvalues
  1197.  
  1198. ***************
  1199. *** Project ***
  1200. ***************
  1201.  
  1202.   1. New
  1203.      -Clears all the text 
  1204.      -No parameter
  1205.      -Nothing
  1206.  
  1207.   2: Open
  1208.      -Loads a text
  1209.      -1:Name of the text (No parameter: opens a filerequester)
  1210.      -Name of the text, if successful, else 10
  1211.  
  1212.   3. Save
  1213.      -Saves a text
  1214.      -No parameter
  1215.      -0 if succesful, else 10
  1216.  
  1217.   4. SaveAs
  1218.      -Saves a text with a new name (the loaded text keeps his name)
  1219.      -1:New name of the text
  1220.      -New name, if succesful, else 10
  1221.  
  1222.   5. Print
  1223.      -Sends the text to the printer
  1224.      -Rückgabewer
  1225.      -0 if successful, else 10
  1226.  
  1227.   6. InsertFile
  1228.      -Inserts a text
  1229.      -1:Name of the text
  1230.      -Name of the inserted text, if successful, else 10
  1231.  
  1232.   7. SaveAllAndQuit
  1233.      -Saves all modified buffers and quits TKEd
  1234.      -No parameter
  1235.      -Nothing
  1236.  
  1237.   8. SaveAndQuit
  1238.      -Saves a text and quits TKEd
  1239.      -No parameter
  1240.      -0 if succesful, else 10
  1241.  
  1242.   9. Quit
  1243.      -Quit TKEd
  1244.      -No parameter (FORCE suppresses the Modified requester)
  1245.      -Nothing
  1246.  
  1247. *************
  1248. *** Prefs ***
  1249. *************
  1250.   1. Indent
  1251.      -Switches indent on/off
  1252.      -ON, to switch on, anything else will switch off
  1253.      -Nothing
  1254.           
  1255.   2. AutoBackup
  1256.      -Switches autobackup on/off
  1257.      -ON, to switch on, anything else will switch off
  1258.      -Nothing
  1259.           
  1260.   3. VersionBackup
  1261.      -Switches versionbackup on/off
  1262.      -ON, to switch on, anything else will switch off
  1263.      -Nothing
  1264.  
  1265.   4. SetExtension
  1266.      -Changes the extension of Backups
  1267.      -String with the extension (up to 10 characters)
  1268.      -Nothing
  1269.  
  1270. **************
  1271. *** Search ***
  1272. **************
  1273.  
  1274.   1. Find
  1275.      -Searches a word in the text
  1276.      -1:word (No parameter: opens a textrequester)
  1277.      -0 if found, else 10
  1278.  
  1279.   2. FindNext
  1280.      -Searches next occurence of the word
  1281.      -No parameters
  1282.      -0 if found, else 10
  1283.  
  1284.   3. FindPrevious
  1285.      -Searches previous occurence of the word
  1286.      -No parameters
  1287.      -0 if found, else 10
  1288.  
  1289.   4. FindChange
  1290.      -Searches for the next occurence of a word and replaces it with another
  1291.      -1:Word to search for  2:Replacing word (no parameter: opens 
  1292.                                               a textrequester)
  1293.      -0 if possible, else 10
  1294.  
  1295.   5. ChangeNext
  1296.      -Searches for the next occurence of a word and replaces it with another
  1297.                                         one
  1298.      -1:Word to search for  2:Replacing word
  1299.      -0 if possible, else 10
  1300.  
  1301.   6. ChangePrevious
  1302.      -Searches for the previous occurence of a word and replaces it with 
  1303.                                          another one
  1304.      -1:Word to search for  2:Replacing word
  1305.      -0 if possible, else 10
  1306.      
  1307.   7. ChangeAll
  1308.      -Replaces all occurences of a word with another
  1309.      -1:Word to search for   2:Replacing word
  1310.      -Nothing
  1311.  
  1312.   8. CountOccurences
  1313.      -Counts all occurences of a word in a text
  1314.      -1:word
  1315.      -Number of occurences
  1316.      
  1317.   9. MatchingBracket
  1318.      -See menu 'Matching Bracket'
  1319.      -No parameters
  1320.      -0 if matching bracket found, else 10
  1321.    
  1322. *****************
  1323. *** BookMarks ***
  1324. *****************
  1325.   
  1326.   1. GotoBookMark
  1327.      -Goes to the mark
  1328.      -Number of the mark (0..9)
  1329.      -0 if successful, else 10
  1330.      
  1331.   2. SetBookMark
  1332.      -Sets a new mark
  1333.      -Number of the new mark (0..9)
  1334.      -0 if successful, else 10
  1335.      
  1336.   3. ClearBookMark
  1337.      -Clears a mark
  1338.      -Number of the mark (0..9)
  1339.      -0 if successful, else 10
  1340.  
  1341. **************
  1342. *** Blocks ***
  1343. **************
  1344.  
  1345.   See also menu 'Blocks' for more information
  1346.  
  1347.   1. Mark
  1348.      -Marks start of a block
  1349.      -No parameters
  1350.      -Nothing
  1351.  
  1352.   2. MarkVertical1
  1353.      -Marks the left end of a vertical block
  1354.      -Cursorposition of the left end (0..length of the line)
  1355.      -0 if possible, else 10
  1356.  
  1357.   3. MarkVertical2
  1358.      -Marks the right end of a vertical block
  1359.      -Cursorposition of the right end (0..length of the line)
  1360.      -0 if possible, else 10
  1361.  
  1362.   4. Cut
  1363.      -See menu 'Cut'
  1364.      -No parameters
  1365.      -Nothing
  1366.      
  1367.   5. Copy
  1368.      -See menu 'Copy'
  1369.      -No parameters
  1370.      -Nothing
  1371.      
  1372.   6. Delete
  1373.      -Deletes all lines of a marked block
  1374.      -No parameters
  1375.      -Nothing
  1376.      
  1377.   7. Paste
  1378.      -See menu 'Paste Block'
  1379.      -No parameters
  1380.      -Nothing
  1381.      
  1382.   8. PasteVertical
  1383.      -See menu 'Paste vertical Block'
  1384.      -No parameters
  1385.      -Nothing
  1386.      
  1387.   9. BlockRight
  1388.      -Moves a marked block one position to the right
  1389.      -No parameters
  1390.      -Nothing
  1391.      
  1392.  10. BlockLeft
  1393.      -Moves a marked block one position to the left
  1394.      -No parameters
  1395.      -Nothing
  1396.      
  1397.  11. UnmarkBlock
  1398.      -Unmarks a block
  1399.      -No parameters
  1400.      -Nothing
  1401.      
  1402.  12. InsertBlock
  1403.      -Opens a filerequester, to load a saved block
  1404.      -No parameters
  1405.      -Nothing
  1406.      
  1407.  13. PrintBlock
  1408.      -Sends a marked block to the printer
  1409.      -No parameters
  1410.      -0 if successful, else 10
  1411.      
  1412.  14. SaveBlock
  1413.      -Opens a filerequester, to save a block
  1414.      -No parameters
  1415.      -Nothing
  1416.  
  1417.  15. Foldmarked
  1418.      -Folds a marked block
  1419.      -No parameters
  1420.      -Nothing
  1421.  
  1422.  16. Fold
  1423.      -Folds all possible parts of a text (seem menu)
  1424.      -No parameters
  1425.      -Nothing
  1426.  
  1427.  17. Unfold
  1428.      -Unfolds all folded text
  1429.      -No parameters
  1430.      -Nothing
  1431.  
  1432.  18. FoldNext
  1433.      -Folds next possible part of a text (see menu)
  1434.      -No parameters
  1435.      -Nothing
  1436.  
  1437.  19. UnfoldNext
  1438.      -Unfolds next folding of a text (see menu)
  1439.      -No parameters
  1440.      -Nothing
  1441.  
  1442.  20. SetFoldOn
  1443.      -Sets the keyword for the beginning of a folding
  1444.      -The neu keyword
  1445.      -Nothing
  1446.  
  1447.  21. SetFoldOff
  1448.      -Sets the keyword for the end of a folding
  1449.      -Neu keyword
  1450.      -Nothing
  1451.  
  1452. *************
  1453. *** Moves ***
  1454. *************
  1455.      
  1456.   1. PreviousPage
  1457.      -Goes to the previous page
  1458.      -No parameters
  1459.      -Nothing
  1460.      
  1461.   2. NextPage
  1462.      -Goes to the next page 
  1463.      -No parameters
  1464.      -Nothing
  1465.      
  1466.   3. BeginOfFile
  1467.      -Goes to the very first character of a text
  1468.      -No parameters
  1469.      -Nothing
  1470.      
  1471.   4. EndOfFile
  1472.      -Goes to the end of the text
  1473.      -No parameters
  1474.      -Nothing
  1475.    
  1476.   5. BeginOfLine
  1477.      -Goes to the very first character of a line
  1478.      -No parameters
  1479.      -Nothing
  1480.      
  1481.   6. EndOfLine
  1482.      -Goes to the right end of a line
  1483.      -No parameters
  1484.      -Nothing
  1485.      
  1486.   7. GotoLine
  1487.      -Goes to a line
  1488.      -Number of the line
  1489.      -0 if successful, else 10
  1490.      
  1491.   8. GotoColumn              Remark: If the line is shorter the the column
  1492.      -Goes to a column        you want to place the cursor at, spaces will be
  1493.      -Number of the column    inserted at the end of the line
  1494.      -0 if successful, else 10
  1495.       
  1496.   9. NextWord
  1497.      -Goes to the next word
  1498.      -No parameters
  1499.      -Nothing
  1500.  
  1501.  10. PreviousWord
  1502.      -Goes to the previous word
  1503.      -No parameters
  1504.      -Nothing
  1505.  
  1506.  11. Cursor
  1507.      -Moves the cursor up/down/left/right
  1508.      -UP, DOWN, LEFT or RIGHT (use capital letters)
  1509.      -Nothing
  1510.             
  1511.  12. Line
  1512.      -Moves cursor the specified number of lines up/down
  1513.      -Number of lines (e.g. 23, -45, +6)
  1514.      -10, if the cursor reaches the beginning/end of the text, else 0
  1515.      
  1516.  13. Column
  1517.      -Moves cursor the specified number of characters to the lft/right
  1518.      -Number of characters (e.g. 23, -45, +6)
  1519.      -10, if the cursor reaches the beginning/end of the line, else 0
  1520.  
  1521.  14. GotoByte
  1522.      -Jumps to the specified byte (= character). The very first byte 
  1523.       is no.=0.
  1524.       If the specified byte is beyond the end of the text, the TKEd jumps 
  1525.       to the very last byte in the text.
  1526.       (Remember: The not visible 'Return'-character at the end of each 
  1527.        line is also one byte)
  1528.      -Number of the byte ( >=0 )
  1529.      -0 if ok, else 10
  1530.  
  1531. **************
  1532. *** Delete ***
  1533. **************
  1534.      
  1535.   1. DeleteWord
  1536.      -Deletes the word under the cursor
  1537.      -No parameters
  1538.      -Nothing
  1539.      
  1540.   2. DeleteLine
  1541.      -Deletes the current line
  1542.      -No parameters
  1543.      -Nothing
  1544.      
  1545.   3. DeleteToEOL
  1546.      -Deletes the current line from the position of the cursor to the end
  1547.                                                        of the line
  1548.      -No parameters
  1549.      -Nothing
  1550.  
  1551. **************
  1552. *** Errors ***
  1553. **************
  1554.  
  1555.   1. FirstError
  1556.      -Displays the first error of an errorfile
  1557.      -If parameter = PROMPT : Shows a requester with the errormessage
  1558.      -Errormessage (if exist), else 10
  1559.      
  1560.   2. NextError
  1561.      -Displays the next error of an errorfile
  1562.      -If parameter = PROMPT : Shows a requester with the errormessage
  1563.      -Errormessage (if exist), else 10
  1564.    
  1565. ************
  1566. *** Keys ***
  1567. ************
  1568.   
  1569.   1. FunctionKey
  1570.      -Executes one of the user-/ARexx-menus
  1571.      -Number 0 to 19 (F1=0 ... F10=9, Shift-F1=10 ... Shift-F10 = 19)
  1572.      -Nothing
  1573.  
  1574.   2. MakeReturn
  1575.      -Same as pressing the 'return'-key
  1576.      -No parameters
  1577.      -Nothing
  1578.  
  1579.   3. del
  1580.      -Same as pressing the 'Del'-key
  1581.      -No parameters
  1582.      -Nothing
  1583.  
  1584.   4. backspace
  1585.      -Same as pressing the '<-' -key
  1586.      -No parameters
  1587.      -Nothing
  1588.  
  1589. ***************
  1590. *** Buffers ***
  1591. ***************
  1592.  
  1593.   1. GotoBuffer
  1594.      -Shows the text in the specified buffer
  1595.      -Number of the buffer (0 to 9)
  1596.      -0 if any text is loaded, 5 if no text is loaded, 10 if error
  1597.  
  1598.   2. GetBufferNr
  1599.      -Returns the number of the current buffer
  1600.      -No parameters
  1601.      -Number of the buffer
  1602.  
  1603.   3. FindBuffer
  1604.      -Searches a buffer and goes to it (if found)
  1605.      -Name of the buffer (not case sensitive); if no name is specified,
  1606.       TKEd switches to the next free buffer (if exist any)
  1607.      -Number of the buffer (0..9) if found; 10 if not found
  1608.  
  1609. ***********************
  1610. *** Get information ***
  1611. ***********************
  1612.      
  1613.   1. GetLineNr
  1614.      -Returns the number of the current line
  1615.      -No parameters
  1616.      -Number of the line
  1617.      
  1618.   2. GetColumnNr
  1619.      -Returns the number of the current column
  1620.      -No parameters
  1621.      -Number of the column
  1622.      
  1623.   3. GetChar
  1624.      -Returns the character at the cursor-position
  1625.      -No parameters
  1626.      -1 character
  1627.      
  1628.   4. GetLine
  1629.      -Returns the text of the current line
  1630.      -No parameters
  1631.      -Text of the line
  1632.  
  1633.   5. GetLineLen
  1634.      -Returns the length of the current line
  1635.      -No parameters
  1636.      Length of the line
  1637.  
  1638.   6. LastLine
  1639.      -Returns the linenumber of the very last line of a text
  1640.      -No parameters
  1641.      -Number of the last line
  1642.      
  1643.   7. GetFileName
  1644.      -Returns the name of the loaded text (without path)
  1645.      -No parameters
  1646.      -Name of the text
  1647.  
  1648.   8. GetPathName
  1649.      -Returns the path to the loaded text (without name)
  1650.      -No parameters
  1651.      -Path of the text
  1652.  
  1653.   9. GetFullPathName
  1654.      -Returns path and name of the loaded text
  1655.      -No parameters
  1656.      -Full pathname of the text
  1657.  
  1658.  10. FirstMarkedLine
  1659.      -Returns the number of the first marked line
  1660.      -No parameters
  1661.      -Number of the first marked line or -1 if nothing is marked
  1662.  
  1663.  
  1664. *********************
  1665. *** Write to text ***
  1666. *********************
  1667.     
  1668.   1. WriteChar
  1669.      -Writes down one character
  1670.      -1 character
  1671.      -0 if successful, else 10
  1672.      
  1673.   2. WriteString
  1674.      -Writes down a string
  1675.      -String (up to 255 characters long)
  1676.      -0 if successful, else 10
  1677.  
  1678. *******************************
  1679. *** Interaction to the user ***
  1680. *******************************
  1681.  
  1682.   1. Request1
  1683.      -Opens a requester to show a text to the user
  1684.      -Text of the requester. If the keyword 'TKED' is in this text,
  1685.       the requester will appear in the window of TKEd.
  1686.       If not, the requester will appear in the the activ window. 
  1687.      -Nothing
  1688.       
  1689.   2. Request2
  1690.      -Opens a requester with two gadgets to show a text to the user
  1691.      -Text of the requester. If the keyword 'TKED' is in this text,
  1692.       the requester will appear in the window of TKEd.
  1693.       If not, the requester will appear in the activ window. 
  1694.      -0 after clcking 'OK', 10 after clicking 'Cancel
  1695.  
  1696.   3. GetNumber
  1697.      -Opens a requester to enter a number
  1698.      -Text at the top of the requester
  1699.      -Number or 0 if the requester was canceled
  1700.  
  1701.   4. GetString
  1702.      -Opens a requester to enter a test. (up to 255 characters)
  1703.      -Text at the top of the requester
  1704.      -Text or 10 if the requester was canceled
  1705.  
  1706.   5. Beep
  1707.      -Makes a 'beep' to signal the user 
  1708.      -No parameters
  1709.      -Nothing
  1710.  
  1711.   6. DisplayBeep
  1712.      -Makes a 'Displaybeep' to signal the user
  1713.      -No parameters
  1714.      -Nothing
  1715.  
  1716.  
  1717. ************
  1718. *** Misc ***
  1719. ************
  1720.  
  1721.   1. JoinLines
  1722.      -Joins the current line with the previous line
  1723.      -No parameters
  1724.      -Nothing 
  1725.  
  1726.   2. CloneLine
  1727.      -Makes a dublicate of the current line
  1728.      -No paramters
  1729.      -Nothing
  1730.  
  1731.   3. SwapChars
  1732.      -Swaps to characters
  1733.      -No parameters
  1734.      -Nothing
  1735.      
  1736.   4. SwapCase
  1737.      -See same menu
  1738.      -No parameters
  1739.      -Nothing
  1740.      
  1741.   5. UpperCase
  1742.      -Changes the character under the cursor from lowercase to uppercase
  1743.      -No parameters
  1744.      -Nothing
  1745.  
  1746.   6. LowerCase
  1747.      -Changes the character under the cursor from uppercase to lowercase
  1748.      -No parameters
  1749.      -Nothing
  1750.  
  1751.   7. EnterAscii
  1752.      -Writes down the ASCII-character belonging to the number
  1753.      -ASCII-number of the character  (0 < number < 256)
  1754.      -0 if successful, else 10
  1755.      
  1756.   8. TKEdtoFront
  1757.      -Pushes the screen of TKEd to the front
  1758.      -No parameters
  1759.      -Nothing
  1760.      
  1761.   9. TKEdtoBack
  1762.      -Pushes the screen of TKEd to the back
  1763.      -No parameters
  1764.      -Nothing
  1765.      
  1766.  10. ReName
  1767.      -Renames the text
  1768.      -New name for the text
  1769.      -Nothing
  1770.  
  1771.  11. Delay
  1772.      -Waits for the specified time
  1773.      -Time to wait in 1/50 seconds (e.g.'Delay 50' will wait for one second)
  1774.      -Nothing
  1775.  
  1776.  12. Sleep
  1777.      -Makes TKEd 'sleeping' (See menu 'Sleep'). The ARREX-program waits as
  1778.       long as TKEd is sleeping; this is an easy way to make one AREXX-
  1779.       program to wait for another: The second AREXX-program only needs to
  1780.       send any AREXX-command to TKEd to 'wake up' TKEd and the first
  1781.       program will continue.
  1782.      -No parameters
  1783.      -Nothing
  1784.      
  1785.      
  1786. Using AREXX, you can realise functions you miss: See the programs in
  1787. the directory 'TKEd:REXX' to have examples how to do this.
  1788.  
  1789.  
  1790. If you have installed AREXX and the command has the name 'rexx:makenumber',
  1791. you can start this program from the 'ARexx'-menus using the 
  1792. command 'makenumber'.
  1793.  
  1794. **************************************************************************
  1795. * Other informations                                                     *
  1796. **************************************************************************
  1797.  
  1798. a)  TKEd is reentrant and the pure-bit is set.
  1799.     So it's easy to make TKEd resident.
  1800.  
  1801. b)  TKEd can load and decrunch texts packed with the powerpacker.
  1802.     TKEd decrunches the text to the ram disk ( 'ram:' ) and loads it.
  1803.     Be sure to have the ram.device in your 'devs:' directory and the
  1804.     ram.handler in your 'l:' directory.   
  1805.     If you have not enough memory to do this, first decrunch
  1806.     the text with the PowerPacker (See Fish 253 for the PD-version of
  1807.     the PowerPacker) and then load the decrunched text.
  1808.    
  1809.    
  1810. c)  Most of the tests of my compiler for NIL-pointers, wrong types, ranges 
  1811.     and so on are still part of TKEd.
  1812.     This reduces the speed of TKEd, but often prevents to see the Guru.
  1813.     If TKEd crashes, a message will appear:
  1814.     If this happens, I would be happy if you would send me a letter with 
  1815.     this message and the function of TKEd which you have called just before
  1816.     error .
  1817.     If you are a registered user I will send you a disk with the newest
  1818.     version of TKEd; if not, I hope that you find the next published version
  1819.     of TKEd (having less errors) good enough to send me the share.
  1820.  
  1821. d)  If you miss a feature, write to me (you need not to be a registered
  1822.     user to do this).
  1823.     I will try to add the mostly asked features to TKEd.
  1824.  
  1825. e)  Nobody is perfect. If I have written 'press right button' and
  1826.     nothing happens, keep cool an try the right one.
  1827.     I often say 'right' when I mean 'left'.
  1828.  
  1829. f)  If you want a TKEd using french, spanish or another language:
  1830.     Send me a letter (or better a disk) with the correct translations
  1831.     of the texts in 'TKEd:Data' for your language.
  1832.     With this data, I will add a menu for your language to the
  1833.     'Prefs'-menu!
  1834.     
  1835. **************************************************************************
  1836.  
  1837.  
  1838. If you have criticism, suggestions, errortools, good AREXX-scripts,
  1839. trouble with TKEd, error reports, gifts or something else 
  1840. write to
  1841.  
  1842. Tom Kroener
  1843. Richard Wagner Str. 40
  1844. D-6602 SB-Dudweiler
  1845. GERMANY  
  1846.  
  1847.                             --- Tom
  1848.     
  1849.     
  1850.     
  1851.  
  1852.  
  1853.  
  1854.   
  1855.  
  1856.